home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / treedupl.arc / TREEDUPL.RNO < prev    next >
Text File  |  1986-09-05  |  32KB  |  894 lines
  1. .PS 58,70
  2. .FL BOLD *
  3. .FL PERIOD +
  4. .NHD
  5. #
  6. .B 9
  7. .C;^*TREEDUPL\*
  8. .C;Directory Tree Duplicator Utility
  9. .C;Reference Manual
  10. .B 9
  11. .C;June 1986
  12. .B
  13. This document describes the TREEDUPL Directory Tree Duplicator
  14. Utility. 
  15. This utility is unlicensed and unsupported.
  16. .B 6
  17. .TS 35
  18. .LM +35
  19. .P -35,1,0
  20. Revision/Update Information:    This is a new manual.
  21. .P -35,1,0
  22. Operating System and Version:    MS-DOS_* version 2.11 or later.
  23. .P -35,1,0
  24. Software Version:    TREEDUPL version 2.0.
  25. .P -35,1,0
  26. Support:    THIS SOFTWARE IS ^*NOT\* SUPPORTED BY DIGITAL
  27. EQUIPMENT CORPORATION. 
  28. .P -35,1,0
  29. Direct questions and comments to:    Brian Hetrick
  30. .BR
  31.     ZKO1-3/J10
  32. .BR
  33.     Digital Equipment Corporation
  34. .BR
  35.     110 Spit Brook Road
  36. .BR
  37.     Nashua NH  03062-2698
  38. .BR
  39.     USA
  40. .LM -35
  41. .B 7
  42. _* MS is a trademark of Microsoft Corporation.
  43. .B
  44. .LT
  45. Digital Equipment Corporation                    Maynard Massachusetts
  46. .EL
  47. .PG
  48. .R;June 1986
  49. .B 4
  50. The information in this document is subject to change without notice
  51. and should not be construed as a commitment by Digital Equipment
  52. Corporation. 
  53. Digital Equipment Corporation assumes no responsibility for any errors
  54. that may appear in this document. 
  55. .B 
  56. The software described in this document is unlicensed and unsupported.
  57. ^*Digital Equipment Corporation assumes no responsibility for the use
  58. or reliability of this software.\* 
  59. This software is provided "as is," without any warranty of any kind,
  60. express or implied. 
  61. Digital Equipment Corporation will not be liable in any event for any
  62. damages including any loss of data, profit, or savings, claims against
  63. the user by any other party, or any other incidental or consequential
  64. damages arising out of the use of, or inability to use, this software,
  65. even if Digital Equipment Corporation is advised of the possibility of
  66. such damage. 
  67. .B 5
  68. This documentation and the software it describes have been placed into
  69. the public domain by Digital Equipment Corporation.
  70. .B 5
  71. The following are trademarks of Digital Equipment Corporation:
  72. .B
  73. .LT
  74.      DEC             MASSBUS         RSX             VAX
  75.      DECmate         PDP             RT              VAXcluster
  76.      DECnet          P/OS            ULTRIX          VMS
  77.      DECUS           Professional    ULTRIX-32       VT
  78.      DECwriter       Rainbow         ULTRIX-32M      Work Processor
  79.      DIBOL           RSTS            UNIBUS
  80.                             _ _ _ _ _ _ _
  81.                            | | | | | | | |
  82.                            |d|i|g|i|t|a|l|
  83.                            |_|_|_|_|_|_|_|
  84. .EL
  85. .PG
  86. .C
  87. ^*Table of Contents\*
  88. .B 2
  89. .R;Page
  90. .B
  91. .LT
  92. Preface                                                              v
  93.     Intended Audience                                                v
  94.     Structure of This Document                                       v
  95.     Associated Documents                                             v
  96.     Conventions Used in This Document                               vi
  97.     Acknowledgments                                                 vi
  98.  
  99. Summary                                                              1
  100.     Format                                                           1
  101.         Command Qualifiers                                           1
  102.         Command Parameters                                           1
  103.  
  104.     Usage                                                            1
  105.         Invoking                                                     1
  106.         Exiting                                                      1
  107.         Directing Output                                             2
  108.  
  109. Description                                                          3
  110.     Invoking the Directory Tree Duplicator Utility                   4
  111.     Restrictions                                                     4
  112.  
  113. Command Qualifiers                                                   6
  114.     /ACCUMULATE Command Qualifier                                    6
  115.         Format                                                       6
  116.         Description                                                  6
  117.         Example                                                      6
  118.  
  119.     /LOG Command Qualifier                                           8
  120.         Format                                                       8
  121.         Description                                                  8
  122.         Example                                                      8
  123.  
  124. Examples                                                             9
  125.     Backing Up a Hard Disk to a DECnet-DOS Virtual Disk              9
  126.     Restoring a Hard Disk from a DECnet-DOS Virtual Disk            10
  127.         Constructing the Bootable Diskette Containing DECnet-DOS    10
  128.         Restoring the Hard Disk from a Virtual Disk Used as a
  129.             Current Copy                                            12
  130.         Restoring the Hard Disk from a Virtual Disk Used as an
  131.             Accumulative Copy                                       13
  132.     Duplicating a Diskette                                          14
  133.     Deleting a Directory Tree                                       15
  134. .EL
  135. .PG
  136. #
  137. .PG
  138. .LO 2,2
  139. .HD ON
  140. .T Directory Tree Duplicator
  141. .ST Preface
  142. .DNM RL
  143. .C
  144. ^*Preface\*
  145. .LM +5
  146. .P -5,3,0
  147. ^*Intended Audience\*
  148. .B
  149. This manual is intended for all MS-DOS and DECnet-DOS users.
  150. .P -5,3,0
  151. ^*Structure of This Document\*
  152. .B
  153. This document has four major sections:
  154. .LS 1,"o"
  155. .LE
  156. The Summary section is an overview of the Directory Tree Duplicator
  157. Utility and is intended as a quick reference guide. 
  158. The Format subsection describes the command that invokes the Directory
  159. Tree Duplicator Utility, listing all command qualifiers and
  160. parameters. 
  161. The Usage subsection describes how to invoke the Directory Tree
  162. Duplicator Utility, how to redirect output, and any restrictions that
  163. you should be aware of. 
  164. .LE
  165. The Description section explains how to use the Directory Tree
  166. Duplicator Utility. 
  167. .LE
  168. The Command Qualifier section describes each command qualifier. 
  169. Command qualifiers appear in alphabetical order.
  170. .LE
  171. The Examples section contains examples of common operations that you
  172. perform with the Directory Tree Duplicator Utility. 
  173. .ELS 0
  174. .P -5,3,0
  175. ^*Associated Documents\*
  176. .B
  177. To use the Directory Tree Duplicator Utility, you should also be
  178. familiar with the following manual: 
  179. .LS 1,"o"
  180. .LE
  181. ^&MS-DOS User's Guide\&, or ^&Disk Operating System\& manual, as
  182. appropriate 
  183. .ELS
  184. To use the Directory Tree Duplicator Utility in conjunction with 
  185. DECnet-DOS virtual disks, you should also be familiar with the 
  186. following manual
  187. .LS 1,"o"
  188. .LE
  189. ^&DECnet-DOS User's Guide\&
  190. .ELS 0
  191. .P -5,3,10
  192. ^*Conventions Used in This Document\*
  193. .LM -5
  194. .TS 26
  195. .LM +26
  196. .P -21,1,0
  197. Convention    Meaning
  198. .P -21,1,0
  199. E_>^*TREEDUPL E:_\ G:_\\*    Command examples show all output lines
  200. or prompting characters that the system prints or displays in normal
  201. type.  All user-entered commands are shown in ^*bold\* type. 
  202. .B
  203. .P -21,1,0
  204. /[NO]LOG    Square brackets indicate that the enclosed item is
  205. optional. 
  206. .P -21,1,0
  207. _<CTRL/x_>    The symbol _<CTRL/x_> indicates that you must press
  208. the key labeled CTRL while you simultaneously press another key, for
  209. example, _<CTRL/C_>. 
  210. .LM -26
  211. .LM +5
  212. .P -5,3,0
  213. ^*Acknowledgments\*
  214. .B
  215. The TREEDUPL Directory Tree Duplicator Utility uses the public domain
  216. command line parsing package written by Bela Lubkin of Borland 
  217. International Inc.
  218. .LM -5
  219. .PG
  220. .NMPG 1
  221. .DNM D
  222. .ST Summary
  223. .C
  224. ^*Summary\*
  225. .LM +5
  226. .B 2
  227. The TREEDUPL program copies or duplicates all files and directories in
  228. an entire directory tree. 
  229. .P -5,3,0
  230. ^*Format\*
  231. .B
  232. TREEDUPL ^&sourceroot\& ^&targetroot\& [^&qualifier\&]
  233. .B
  234. .TS 35
  235. ^*Command Qualifiers\*    ^*Defaults\*
  236. .B
  237. /[NO]ACCUMULATE    /ACCUMULATE
  238. .BR
  239. /[NO]LOG    /LOG
  240. .B 2
  241. ^*Command Parameters\*
  242. .LM +5
  243. .P -5,1,0
  244. ^&sourceroot\&
  245. .B
  246. Specifies the name for the root of the directory tree to be copied or
  247. duplicated. 
  248. .P -5,1,3
  249. ^&targetroot\&
  250. .B
  251. Specifies the name for the root of the directory tree into which the
  252. tree specified by ^&sourceroot\& is to be copied or duplicated. 
  253. .P -10,3,0
  254. ^*Usage\*
  255. .P -5,1,0
  256. ^*Invoking\*
  257. .B
  258. You invoke the Directory Tree Duplicator Utility with the TREEDUPL
  259. command.
  260. .P -5,1,0
  261. ^*Exiting\*
  262. .B
  263. You exit the Directory Tree Duplicator Utility normally by waiting
  264. until processing is complete.
  265. The Directory Tree Duplicator Utility will return control to the 
  266. command interpreter when processing is complete.
  267. .B
  268. You can exit the Directory Tree Duplicator Utility abnormally by
  269. typing _<CTRL/C_>, if the /NOLOG command qualifier has not been given 
  270. or if the MS-DOS BREAK parameter is ON.
  271. .P -5,1,0
  272. ^*Directing Output\*
  273. .B
  274. By default, messages from the Directory Tree Duplicator Utility are 
  275. directed to the console device.
  276. Such messages may be directed to another device or a file with the 
  277. I/O redirection facilities of the command interpreter.
  278. .LM -10
  279. .PG
  280. .ST Description
  281. .C
  282. ^*Description\*
  283. .LM +5
  284. .B
  285. The Directory Tree Duplicator Utility is a command-line oriented
  286. program used to copy all directories and files in an entire directory
  287. tree to another directory, or to force one directory tree to duplicate
  288. another. 
  289. .B
  290. Through the use of the Directory Tree Duplicator Utility, you can
  291. maintain a backup copy of your personal computer's hard disk in a
  292. DECnet-DOS virtual disk maintained an another node of a DECnet
  293. network, or duplicate the complete contents of a diskette on another
  294. diskette, or delete an entire directory tree, or move an entire
  295. directory tree from one directory to another. 
  296. .P -5,3,0
  297. ^*Invoking the Directory Tree Duplicator Utility\*
  298. .B
  299. The Directory Tree Duplicator Utility is invoked with the TREEDUPL
  300. command, followed by the name of the root directory of the source
  301. directory tree (the directory tree to be copied or duplicated),
  302. followed by the name of the root directory of the target directory
  303. tree (the directory tree to be produced). 
  304. No wild card characters are allowed in either name.
  305. Command qualifiers may follow any of these components of the command. 
  306. For example, the following command copies all directories and files on
  307. the volume in drive A to the volume in drive B: 
  308. .P 5,1,0
  309. E_>^*TREEDUPL A:_\ B:_\\*
  310. .B
  311. If a drive letter is specified, the directory is interpreted as 
  312. residing on the volume in the specified drive.
  313. Otherwise, the directory is interpreted as residing on the volume in 
  314. the current drive.
  315. If the directory name starts with a back slash (_\), the directory
  316. name is interpreted as relative to the root directory of the volume. 
  317. Otherwise, the directory name is interpreted as relative to the
  318. current directory on the volume. 
  319. .B
  320. If the current directory on the volume in drive E is the root 
  321. directory, and the current directory on the volume in drive G is 
  322. _\E__SAVE, then the command:
  323. .P 5,1,0
  324. E_>^*TREEDUPL E:#G:\*
  325. .B
  326. will copy all directories and files on the entire volume in drive E
  327. into a directory tree rooted at the directory _\E__SAVE of the volume
  328. in drive G. 
  329. .B
  330. Except in the root directory of a volume, a single period (.) in the
  331. place of the first directory name refers to the current directory, and
  332. two periods (..) refers to the parent of the current directory. 
  333. In the root directory of a volume, these cannot be used.
  334. A single back slash always refers to the root directory of a volume.
  335. .B
  336. The Directory Tree Duplicator Utility copies all directories and files
  337. from the source directory tree to the target directory tree. 
  338. However, the Directory Tree Duplicator Utility will attempt not to 
  339. copy files which are apparently already at the appropriate position in
  340. the target directory tree.
  341. For non-directory files, the Directory Tree Duplicator Utility will
  342. not copy a file in the source directory tree (the "source file") if: 
  343. .LS 1,"o"
  344. .LE
  345. There is a file of the same name in the corresponding position in the 
  346. target directory tree (the "target file");
  347. .LE
  348. The sizes of the source file and the target file are equal;
  349. .LE
  350. The modification dates and times of the source file and the target 
  351. file are equal.
  352. .ELS 0
  353. .B
  354. If there is a target file that appears to be the same as the source
  355. file based on these characteristics, then its contents are not
  356. modified, but its file attributes (read-only, system, hidden, and
  357. archive) are set to be the same as those of the source file. 
  358. .B
  359. If there is a target file that appears to be different from the source
  360. file based on these characteristics, then the target file is deleted
  361. and the source file is copied to its place. 
  362. The file size, file attributes (read only, hidden, system, and
  363. archive), and file modification date and time of the copy are set to 
  364. duplicate those of the source file.
  365. .B
  366. For a directory in the source directory tree, the Directory Tree
  367. Duplicator Utility will create a corresponding directory in the target
  368. directory tree unless one already exists. 
  369. The file attributes of the new or existing directory are set to be the 
  370. same as those of the directory in the source directory tree.
  371. .B
  372. The Directory Tree Duplicator Utility can also delete all files in
  373. the target directory tree that are not in the source directory tree.
  374. The /ACCUMULATE command qualifier controls this behavior.
  375. .B
  376. By default, the Directory Tree Duplicator Utility issues messages 
  377. describing its actions.
  378. These messages can be suppressed.
  379. The /LOG command qualifier controls this behavior.
  380. .P -5,3,3
  381. ^*Restrictions\*
  382. .B
  383. The Directory Tree Duplicator Utility cannot be used to copy a 
  384. source directory tree into a target directory tree whose root is in 
  385. the source directory tree itself.
  386. For example, the command:
  387. .P 5,1,0
  388. E_>^*TREEDUPL E:_\SUBDIR1 E:_\SUBDIR1_\SUBDIR2\*
  389. .B
  390. would fail as the _\SUBDIR1_\SUBDIR2 directory is in the directory
  391. tree having _\SUBDIR1 as its root.
  392. .LM -5
  393. .PG
  394. .ST Command Qualifiers
  395. .C
  396. ^*/ACCUMULATE Command Qualifier\*
  397. .LM +5
  398. .P -5,3,0
  399. ^*Format\*
  400. .B
  401. /ACCUMULATE
  402. .BR
  403. /NOACCUMULATE
  404. .P -5,3,0
  405. ^*Description\*
  406. .B
  407. By default, the Directory Tree Duplicator Utility retains all files
  408. and directories in the target directory, unless there is a 
  409. corresponding file in the source directory tree that is different from 
  410. the file or directory in the target directory.
  411. However, the Directory Tree Duplicator Utility can "prune" the target 
  412. directory tree, that is, delete files and directories that do not
  413. appear in the source directory tree. 
  414. The /ACCUMULATE command qualifier controls this behavior.
  415. If you specify /NOACCUMULATE, files and directories in the target
  416. directory that do not appear in the source directory are deleted. 
  417. If you omit the qualifier or specify /ACCUMULATE, files in the target 
  418. directory that do not appear in the source directory are retained.
  419. .B
  420. If you specify /NOACCUMULATE, even files and directories in the target 
  421. directory tree with the read-only attribute are deleted if they do not 
  422. exist in the source directory tree.
  423. .P -5,3,0
  424. ^*Example\*
  425. .B
  426. E_>^*TREEDUPL A:_\ B:_\ /NOACCUMULATE\*
  427. .LT
  428. TREEDUPL version 2.0
  429.  
  430. Copied A:\AUTOEXEC.BAT to B:\AUTOEXEC.BAT
  431. Copied A:\COMMAND.COM to B:\COMMAND.COM
  432. Copied A:\CONFIG.SYS to B:\CONFIG.SYS
  433. Copied A:\IO.SYS to B:\IO.SYS
  434. Copied A:\MSDOS.SYS to B:\MSDOS.SYS
  435. Deleted B:\TREEDUPL\CLA.PAS
  436. Deleted B:\TREEDUPL\TREEDUPL.COM
  437. Deleted B:\TREEDUPL\TREEDUPL.PAS
  438. Deleted B:\TREEDUPL
  439.  
  440. E>
  441. .EL
  442. .B
  443. With this command, the directory tree of the volume mounted in drive A
  444. is exactly replicated on the volume mounted in drive B.
  445. Files on the volume in drive A that are not on the volume in drive B 
  446. are copied onto the volume in drive B; files on the volume in drive B 
  447. that are not on the volume in drive A are deleted.
  448. In the example, the _\TREEDUPL directory of the volume in drive B did
  449. not appear on the volume in drive A, and so the directory's contents
  450. and then the directory itself were deleted. 
  451. .LM -5
  452. .PG
  453. .C
  454. ^*/LOG Command Qualifier\*
  455. .LM +5
  456. .P -5,3,0
  457. ^*Format\*
  458. .B
  459. /LOG
  460. .BR
  461. /NOLOG
  462. .P -5,3,0
  463. ^*Description\*
  464. .B
  465. By default, the Directory Tree Duplicator Utility produces messages
  466. describing its actions. 
  467. These messages are produced on the standard output, which is normally 
  468. directed to the console.
  469. The /LOG command qualifier controls the production of these messages.
  470. If you specify /NOLOG, no messages are produced.
  471. If you omit the qualifier or specify /LOG, messages are produced 
  472. whenever a file is copied or deleted, a directory is created or 
  473. deleted, and whenever a file's attributes are modified.
  474. .P -5,3,0
  475. ^*Example\*
  476. .B
  477. E_>^*TREEDUPL A:_\ B:_\ /NOLOG\*
  478. .BR
  479. TREEDUPL version 2.0
  480. .B
  481. E_>
  482. .B
  483. With this command, messages describing the actions taken by the
  484. Directory Tree Duplicator Utility to copy the files on the volume in
  485. drive A to the volume in drive B are not issued. 
  486. .LM -5
  487. .PG
  488. .ST Examples
  489. .C
  490. ^*Examples\*
  491. .LM +5
  492. .P -5,3,0
  493. ^*Backing Up a Hard Disk to a DECnet-DOS Virtual Disk\*
  494. .B
  495. You can make a backup copy of the data on your hard disk using a 
  496. DECnet-DOS virtual disk as the backup medium.
  497. The DECnet-DOS virtual disk will then be backed up to archival storage 
  498. (for example, magnetic tape) under the standard backup procedures for 
  499. the remote node on which the virtual disk resides.
  500. This form of backup can be unattended, as it is not necessary to
  501. change volumes in a small capacity diskette drive. 
  502. .B
  503. You should first decide whether you want to keep a ^¤t\& copy of 
  504. the data on your disk, or an ^&accumulative\& copy of the data on your 
  505. disk.
  506. A current copy will have only the data on your disk as of the most 
  507. recent backup;  an accumulative copy will retain old files that you 
  508. have deleted on your disk.
  509. However, an accumulative copy will not retain old versions of files 
  510. that still exist;  only the most recent version of any file will is 
  511. retained.
  512. An accumulative copy will require a larger virtual disk than will a 
  513. current copy.
  514. Also, an accumulative copy is more difficult to restore from than is a 
  515. current copy.
  516. .B
  517. Similarly, if you have several hard disks, you should decide whether 
  518. to back these up into a single virtual disk or into several virtual
  519. disks. 
  520. Backing up several hard disks into a single virtual disk will require
  521. a larger virtual disk than will backing up each hard disk into
  522. separate virtual disks. 
  523. .B
  524. Before backing up your hard disk's data for the first time, you must
  525. create the DECnet-DOS virtual disk. 
  526. You do this using the DECnet-DOS NDU (&Network &Device &Utility)
  527. CREATE command. 
  528. For example, the command:
  529. .P 5,1,0
  530. E_>^*NDU CREATE DRIVE G NODE EVER11 NDISK HD_BACKUP.DSK MAX 32\*
  531. .B
  532. creates a 32 megabyte virtual disk in the default directory of the 
  533. account specified by the default access control string for node 
  534. EVER11, and makes that disk available through MS-DOS drive letter G.
  535. .B
  536. After using the NDU CREATE command, to create a new virtual disk, or 
  537. the NDU OPEN command, to access an already existing virtual disk, you 
  538. can backup your hard disk contents by using the Directory Tree 
  539. Duplication Utility to copy the hard disk contents to the virtual 
  540. disk.
  541. For example, the commands:
  542. .B
  543. .LM +5
  544. .TP 4
  545. E_>^*TREEDUPL E:_\ G:_\E__BACKUP /NOLOG\*
  546. .BR
  547. TREEDUPL version 2.0
  548. .B
  549. .TP 4
  550. E_>^*TREEDUPL F:_\ G:_\F__BACKUP /NOLOG\*
  551. .BR
  552. TREEDUPL version 2.0
  553. .LM -5
  554. .B
  555. copy all files and directories on the hard disk in drive E into the 
  556. directory _\E__BACKUP on the virtual disk currently accessed through 
  557. drive letter G, and copies all files and directories on the hard disk 
  558. in drive F into the directory _\F__BACKUP on the virtual disk 
  559. currently accessed through drive letter G.
  560. Because the /NOACCUMULATE command qualifier is not specified,
  561. accumulative copies of the data on the hard disks in drives E and F
  562. are made.
  563. Similarly, the commands: 
  564. .B
  565. .LM +5
  566. .TP 4
  567. E_>^*TREEDUPL/NOACCUMULATE E:_\ G:_\E__BACKUP /NOLOG\*
  568. .BR
  569. TREEDUPL version 2.0
  570. .B
  571. .TP 4
  572. E_>^*TREEDUPL/NOACCUMULATE F:_\ G:_\F__BACKUP /NOLOG\*
  573. .BR
  574. TREEDUPL version 2.0
  575. .LM -5
  576. .B
  577. construct current copies of the data on the hard disks in drives E and 
  578. F.
  579. .P -5,3,0
  580. ^*Restoring a Hard Disk from a DECnet-DOS Virtual Disk\*
  581. .B
  582. You can restore the contents of a corrupted hard disk from a
  583. DECnet-DOS virtual disk which has been used as an accumulative or a
  584. current copy of the files and directories on your disk. 
  585. As the hard disk may be unusable as a system device should this prove
  586. necessary, you will need to have on a diskette a system sufficient to
  587. restore the files and directories on the virtual disk to the hard
  588. disk.
  589. You can then use this diskette based system to restore the contents of 
  590. the hard disk from the virtual disk copy.
  591. .LM +5
  592. .P -5,1,0
  593. ^*Constructing the Bootable Diskette Containing DECnet-DOS\*
  594. .B
  595. You must first construct a bootable diskette system that permits you
  596. to access DECnet-DOS virtual disks. 
  597. First, format a system diskette; for example, the command: 
  598. .P 5,1,0
  599. E_>^*FORMAT A:/S\*
  600. .B
  601. will construct a bootable diskette containing only the MS-DOS system
  602. on the diskette in drive A. 
  603. Then, ensure that the necessary DECnet-DOS files are on the diskette. 
  604. You may either install DECnet-DOS onto the diskette, or copy the
  605. DECnet-DOS files from your hard disk onto the diskette. 
  606. In either case, the only purpose of this DECnet-DOS installation is to
  607. access a virtual disk on a single remote node, so most DECnet-DOS
  608. utilities need not be included. 
  609. For example, a bootable system diskette for a Rainbow 100A system to
  610. be used with a serial communications line that is dynamically switched
  611. to DDCMP protocol might contain the visible files: 
  612. .LM +5
  613. .B
  614. .TP 3
  615. .LT
  616. COMMAND.COM   The MS-DOS command interpreter
  617. NDDRV.SYS     Network disk driver
  618. FIX100A.COM   Rainbow 100A interrupt structure fixup
  619. SCH.EXE       DECnet-DOS scheduler
  620. DNP.EXE       DECnet-DOS DECnet process
  621. NCP.EXE       Network Control Program
  622. NCP.TXT       Initialization commands for NCP
  623. NDU.EXE       Network Device Utility
  624. CONFIG.SYS    MS-DOS boot configuration commands
  625. AUTOEXEC.BAT  Startup commands
  626. KERMIT.EXE    Terminal emulation program
  627. DECNET        Empty subdirectory
  628. TREEDUPL.COM  The Directory Tree Duplicator Utility
  629. .EL
  630. .LM -5
  631. .B
  632. The contents of CONFIG.SYS might be:
  633. .LM +5
  634. .B
  635. .TP 3
  636. .LT
  637. DEVICE=NDDRV.SYS
  638. FILES=20
  639. BUFFERS=32
  640. .EL
  641. .LM -5
  642. .B
  643. while the contents of AUTOEXEC.BAT might be:
  644. .LM +5
  645. .B
  646. .TP 4
  647. .LT
  648. PATH A:\
  649. FIX100A
  650. SCH
  651. DNP A:\DECNET\
  652. .EL
  653. .LM -5
  654. .B
  655. Complete installation  of  DECnet-DOS by booting this diskette,
  656. invoking NCP to accept the commands in NCP.TXT, and defining the
  657. transmit and receive passwords, if any, and defining the adjacent node
  658. and the remote node on which the virtual disk resides. 
  659. .B
  660. You should test this diskette by rebooting from it to install the now
  661. initialized DECnet network, and bring up the DECnet line in the normal
  662. fashion. 
  663. Then use the NDU OPEN command to attempt to access the virtual disk
  664. you are using as a backup of your hard disk. 
  665. When you can access the files on the virtual disk using only the
  666. system on the diskette, you have created the bootable diskette
  667. containing DECnet-DOS that can be used to restore the hard disk should
  668. it become corrupt. 
  669. .LM -5
  670. .B
  671. .TP 4
  672. ^*Restoring the Hard Disk from a Virtual Disk Used as a Current Copy\*
  673. .LM +5
  674. .B
  675. To restore the contents of the hard disk from a virtual disk, you must
  676. first ensure that the hard disk is in a state acceptable to MS-DOS. 
  677. This may require that you format the disk, and, if the hard disk is to
  678. be bootable, install the MS-DOS system. 
  679. .B
  680. When the hard disk has been prepared, you must boot the diskette
  681. containing DECnet-DOS, bring up the DECnet line in the normal fashion,
  682. and use the NDU utility to make accessible the virtual disk containing
  683. the current copy of the hard disk's contents. 
  684. .B
  685. If files or directories have been stored onto the hard disk which are
  686. not to be destroyed (for example, the MS-DOS operating system), you
  687. must now use the standard MS-DOS COPY and MKDIR commands, or the
  688. Directory Tree Duplicator Utility, to ensure that these files and
  689. directories are reflected in the virtual disk. 
  690. For example, the command: 
  691. .LM +5
  692. .B
  693. .TP 4
  694. A_>^*TREEDUPL E:_\ I:_\ /NOLOG\*
  695. .BR
  696. TREEDUPL version 2.0
  697. .LM -5
  698. .B
  699. would ensure that restoring the files and directories on the virtual
  700. disk accessible through drive letter I to the hard disk in drive E
  701. would not overwrite the files and directories currently on the hard
  702. disk in drive E. 
  703. .B
  704. Now, you can copy the files and directories on the virtual disk to the
  705. hard disk using the Directory Tree Duplicator Utility. 
  706. For example, the command:
  707. .LM +5
  708. .B
  709. .TP 4
  710. A_>^*TREEDUPL I:_\ E:_\ /NOLOG\*
  711. .BR
  712. TREEDUPL version 2.0
  713. .LM -5
  714. .B
  715. would copy all files on the virtual disk accessible through drive
  716. letter I to the hard disk in drive E. 
  717. .B
  718. At this point, the files and directories have been restored.
  719. You can now boot the computer in your usual fashion and proceed with
  720. the newly restored hard disk. 
  721. .LM -5
  722. .B
  723. .TP 4
  724. ^*Restoring the Hard Disk from a Virtual Disk Used as an Accumulative
  725. Copy\*
  726. .LM +5
  727. .B
  728. To restore the contents of the hard disk from a virtual disk, you must
  729. first ensure that the hard disk is in a state acceptable to MS-DOS. 
  730. This may require that you format the disk, and, if the hard disk is to
  731. be bootable, install the MS-DOS system. 
  732. .B
  733. When the hard disk has been prepared, you must boot the bootable
  734. diskette containing DECnet-DOS, bring up the DECnet line in the
  735. normal fashion, and use the NDU utility to make accessible the virtual
  736. disk containing the accumulative copy of the hard disk's contents.
  737. .B
  738. If files or directories have been stored onto the hard disk which are
  739. not to be destroyed (for example, the MS-DOS operating system), you
  740. must now use the standard MS-DOS COPY and MKDIR commands, or the
  741. Directory Tree Duplicator Utility, to ensure that these files and
  742. directories are reflected in the virtual disk. 
  743. For example, the command: 
  744. .LM +5
  745. .B
  746. .TP 4
  747. A_>^*TREEDUPL E:_\ I:_\ /NOLOG\*
  748. .BR
  749. TREEDUPL version 2.0
  750. .LM -5
  751. .B
  752. would ensure that restoring the files and directories on the virtual
  753. disk accessible through drive letter I to the hard disk in drive E
  754. would not overwrite the files and directories currently on the hard
  755. disk in drive E. 
  756. .B
  757. If the files and directories on the virtual disk will fit onto the
  758. hard disk, the simplest procedure is to restore the entire contents of
  759. the virtual disk to the hard disk and then to individually delete
  760. files and directory trees that are not needed. 
  761. For example, the command: 
  762. .LM +5
  763. .B
  764. .TP 4
  765. A_>^*TREEDUPL I:_\ E:_\ /NOLOG\*
  766. .BR
  767. TREEDUPL version 2.0
  768. .LM -5
  769. .B
  770. would copy all files on the virtual disk accessible through drive
  771. letter I to the hard disk in drive E. 
  772. The unwanted 
  773. files and directories could then be deleted with the 
  774. standard MS-DOS DEL and RMDIR commands, and entire unwanted 
  775. directory trees could then be deleted with the Directory 
  776. Tree Duplicator Utility.
  777. .B
  778. If the files and directories on the virtual disk will not fit onto the
  779. hard disk, then copying all files and directories on the virtual disk
  780. to the hard disk is not possible. 
  781. You must manually direct a process in which only some of the files and
  782. directories on the virtual disk are copied onto the hard disk. 
  783. .B
  784. The first method of copying only some files and directories on the
  785. virtual disk onto the hard disk is to copy individual files and
  786. directory trees from the virtual disk to the hard disk using the
  787. standard MS-DOS MKDIR and COPY commands, and the Directory Tree
  788. Duplicator Utility. 
  789. .B
  790. The second method of copying only some files and directories on the
  791. virtual disk onto the hard disk is to delete individual files and
  792. directory trees from the virtual disk, using the standard MS-DOS DEL
  793. and RMDIR commands, and the Directory Tree Duplicator Utility, and 
  794. then copy all remaining files and directories on the virtual disk to
  795. the hard disk. 
  796. Since this process destroys some of the contents of the virtual disk,
  797. you may want to use the DECnet network remote node's file copy command
  798. to create a temporary duplicate of the virtual disk. 
  799. This temporary duplicate of the virtual disk can be used as the
  800. virtual disk from which the restoration is to take place:  individual
  801. files and directory trees may be deleted freely from the temporary
  802. duplicate, without affecting the contents of the original virtual
  803. disk. 
  804. .B
  805. When all files and directories of interest have been restored, you can
  806. boot the computer in your usual fashion and proceed with the newly
  807. restored hard disk. 
  808. .LM -5
  809. .P -5,3,0
  810. ^*Duplicating a Diskette\*
  811. .B
  812. You can duplicate the contents of a diskette using the Directory Tree
  813. Duplicator Utility. 
  814. .B
  815. First, place the diskette to be duplicated into one diskette drive.
  816. Then, place the diskette onto which the duplicate is to be made into 
  817. a second diskette drive.
  818. It is advisable to format the second diskette, but this step is often 
  819. not necessary.
  820. Then use the TREEDUPL command with the /NOACCUMULATE command qualifier 
  821. to duplicate the contents of the first diskette onto the second 
  822. diskette.
  823. .B
  824. For example, if the diskette to be duplicated has been placed into 
  825. drive A, and the diskette to receive the copy has been placed into 
  826. drive B, then the command:
  827. .LM +5
  828. .B
  829. E_>^*TREEDUPL A:_\ B:_\ /NOACCUMULATE /NOLOG\*
  830. .LM -5
  831. .B
  832. will duplicate the contents of the diskette in drive A onto the 
  833. diskette in drive B.
  834. .B
  835. It is possible to duplicate the contents of a diskette even if you 
  836. have only one diskette drive, as long as you have a hard disk or 
  837. DECnet-DOS virtual disk with enough free space.
  838. First, duplicate the diskette into a newly created directory on the 
  839. hard disk or DECnet-DOS virtual disk;  then duplicate the directory on 
  840. the hard disk or DECnet-DOS virtual disk.
  841. .B
  842. For example, the commands:
  843. .B
  844. .LM +5
  845. E_>^*MKDIR E:_\DISKCOPY\*
  846. .B
  847. E_>^*TREEDUPL A:_\ E:_\DISKCOPY/NOLOG\*
  848. .BR
  849. TREEDUPL version 2.0
  850. .LM -5
  851. .B
  852. create a directory on the disk in drive E, and then copy the contents 
  853. of the diskette in drive A into that directory.  The subsequent 
  854. command:
  855. .B
  856. .LM +5
  857. E_>^*TREEDUPL/NOACCUMULATE/NOLOG E:_\DISKCOPY A:_\\*
  858. .BR
  859. TREEDUPL version 2.0
  860. .LM -5
  861. .B
  862. will copy the directories and files onto the diskette in drive A.
  863. .P -5,3,0
  864. ^*Deleting a Directory Tree\*
  865. .B 
  866. You can delete an entire directory tree, even if it contains
  867. read-only, hidden, or system files, using the Directory Tree 
  868. Duplicator Utility.
  869. .B
  870. You first create an empty directory, then copy it to the root of the 
  871. directory tree to be deleted using the /NOACCUMULATE command
  872. qualifier, then remove both the empty directory you created and the
  873. now-empty directory. 
  874. For example, to remove the directory tree rooted at _\WORK_\QRTR1, you 
  875. could issue the commands:
  876. .LM +5
  877. .B
  878. E_>^*MKDIR _\EMPTY\*
  879. .B
  880. E_>^*TREEDUPL/NOLOG/NOACCUMULATE _\EMPTY _\WORK_\QRTR1\*
  881. .BR
  882. TREEDUPL version 2.0
  883. .B
  884. E_>^*RMDIR _\EMPTY\*
  885. .B
  886. E_>^*RMDIR _\WORK_\QRTR1\*
  887. .LM -5
  888. .B
  889. You must use the /NOACCUMULATE command qualifier, to delete the 
  890. directories and files in the directory tree rooted at _\WORK_\QRTR1;  
  891. you may optionally use the /NOLOG command qualifier to suppress the
  892. printing of messages naming the files as they are deleted.
  893. .LM -5
  894.